The Folder Converter tab allows you to convert all Java code
within a folder. Once the files are converted, you can then view Java to Python Converter
comments, compare converted code files to original code files, and view the converted
code folder.
The Conversion History listview displays previously converted sources and allows you to
view remaining Java to Python Converter comments and view the converted code folder.
The File & Snippet Converter tab allows you to convert Java code snippets or files. From the left side textbox, you can type or paste code snippets, insert files, or view Java to Python Converter sample snippets. Once a file or snippet is converted, you can select and copy the results, save the results to a file, or search the results.
Java to Python Converter can be launched from the command line
with two or three parameters. If you specify folders, the first parameter is the folder
containing the .java files that you wish to convert and the second parameter is the folder
that the converted files will be written to. If you specify files, the first parameter
is the source code file that you wish to convert and the second parameter is the name
of the converted Python file. If a third parameter is supplied, then it is interpreted as
the location of a conversion options file to import before the conversion starts. A conversion options file
has the extension '.opt' and is produced by exporting existing options to an xml file from the converter.
e.g. (folder conversion),
"Java to Python Converter" "C:\Java Source Files" "C:\Python Converted Files"
e.g. (file conversion),
"Java to Python Converter" "C:\Java Source Files\testfile.java" "C:\Python Converted Files\testfile.py"
e.g. (folder conversion with a conversion options file specified),
"Java to Python Converter" "C:\Java Source Files" "C:\Python Converted Files" "C:\Options\Java to Python Converter.opt"
Once the command line conversion is complete, Java to Python Converter will shut down.
Note that Java to Python Converter must be in double quotes since the executable name
contains spaces.
On this options dialog, you can customize the comment prefixes
that the converter uses for messages and also toggle the messages that Java to Python Converter
displays on or off.
You can easily set all or none to display via the 'Select All' and 'Select None' buttons.
Java to Python Converter allows you to specify your own custom
replacements in the converted code. This can be useful for cases where you wish to
specify a replacement for a Java library data type that isn't handle by
Java to Python Converter.
For each replacement string you can specify the regex option, when to perform the replacement
(pre or post conversion), whether or not to match case, whether to match whole words only,
and whether comments or string literals should be modified. The whole words and string literals
options do not apply if the regex option is selected.
To span mulitple lines, either paste directly into the 'Find' and 'Replacement'
textboxes, or use the escaped characters: \r\n\t.
The "Active" checkbox can be unchecked if you wish to temporarily bypass the replacement.
Replacements are made in the order that they appear on the options dialog. For example,
the second replacement is made to each line of code after the first replacement has already
been made. To change the order of replacements, use the 'Up' and 'Down' buttons.
For an example of the regex option, you could do a custom replacement of "Foo(x)" with "Bar(x)",
where "x" is any argument, by specifying the "Find" field as "Foo(([\sa-zA-Z_$]*))" and the
"Replace" field as "Bar$1". Note that there are differences in various regex engines - the
regex engine used by the converter is .NET System.Text.RegularExpressions.Regex.
These options are intended to provide information to Tangible Software Solutions if a conversion is taking longer than expected. 'Record processing by file' instructs the converter to make a record of the files processed and the time taken for each process. 'Record the last 100 lines of code parsed before cancelling conversion' instructs the converter to make a record of the most recent lines parsed before you cancelled the conversion.
The converter detects input file encoding from the byte order mark (BOM), but if the BOM is missing the converter assumes by default that the file encoding is UTF-8. You can use this option to specify a different default encoding to use in the absence of a BOM. Output is written in the same encoding as the encoding detected for the original file, or your default encoding option if the original coding was not detected via the BOM. For UTF-8, you can choose whether or not to include the BOM for the output - this is normally used in Windows environments.
Copyright © Tangible Software Solutions, Inc.